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variable A 
(type Object) 



Thread 1 



Thread 1.1 



value 1A 



value 2A 



childValue method 



Thread 2 



value 
1.1A 



value 
2.1A 



Thread 2.1 



Constructor Summa 

ThreadLocal 0 

Creates a ThreadLocal variable. 



Method Summary 



Object 


get() 

Returns the value in the calling thread's copy of this ThreadLocal variable. 


Protected 
Object 


InitialValue 0 

Returns the calling thread's initial value for this ThreadLocal variable. 


void 


set (Object value) 

Sets the calling thread's instance of this ThreadLocal variable to the given value 



Methods inherited from class java.lang.Object 

clone , equals , finalize, getClass, hashCode, notify , notifyAH , notifyAll, toString, wait, 



Constructor Detail 



ThreadLocal 

public ThreadLocal 

Creates a ThreadLocal variable. 



Method Detail 



initialValue 

protected Object initialValue ( ) 

Returns the calling thread's initial value for this ThreadLocal variable. This method will be 
called once per accessing thread for each ThreadLocal, the first time each thread accesses the 
variable with get or set. If the programmer desires ThreadLocal variables to be initialized to 
some value other than null, ThreadLocal must be subclassed, and this method overriden. 
Typically, an anonymous inner class will be used. Typical implementations of initial Value 
will call an appropriate constructor and return the newly constructed object. 



get 

public Object get ( ) 

Returns the value in the calling thread's copy of this ThreadLocal variable. Creates and 
initializes the copy if this is the first time the thread has called this method. 



public void set (Object value) 

Sets the calling thread's instance of this ThreadLocal variable to the given value. This is only 
used to change the value from the one assigned by the initialValue method, and many 
applications will have no need for this functionality. 
Parameters 

value - the value to be stored in the calling threads' copy of this ThreadLocal. 




Constructor Summary 





InheritableThreadLocal ( ) 



Creates an Inheritable ThreadLocal variable. 



Method Summary 



protected 
Object 



childValuc (Object parentValue) ^ 

Computes the child's initial value for this Inheribatle ThreadLocal as a function 
of the parent's value at the time the child Thread is created. 



Methods inherited from class java.lang.ThreadLocal 



get , initialValue , set 



Methods inherited from class java.lang.Object 



clone , equals, finalize, getClass, hashCode, notify, notifyAU, toString, wait 



Constructor Detail 



InheritableThreadLocal 

public InheritableThreadLocal ( ) 

Creates an InheritableThreadLocal variable. 



Method Detail 



childValue 

protected Object childValue (Object parentValue) 

Computes the child's initial value for this Inheritable ThreadLocal as a function of the parent's 
value at the time the child Thread is created. This method is called from within the parent 
thread before the child is started. 

This method merely returns its input argument, and should be overridden if a different 
behavior is desired. 



* 



Thread 1 



Inheritable Hash Table 1 


TLRA 


value 1A 


TLRB 


value IB 







TLR = Thread-Local Reference 



Non-Inheritable Hash Table 1 


TLRX 


value IX 











Thread 2 



TLR = Thread-Local Reference 



Inheritable Hash Table 2 


TLRA 


value 2A 


TLRB 


value 2B 







Non-Inheritable Hash Table 2 


TLRX 


value 2X 
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